home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / grepfv2.arc / GREPFV2.DOC next >
Text File  |  1991-04-07  |  3KB  |  90 lines
  1. GREPFV
  2. By Nigel Salt (c) 1991
  3. All rights reserved
  4.  
  5. GREPFV is a text string searching utility with a difference. It
  6. searches for regular expressions in text files, archived files,
  7. and executable files. It will automatically unarchive ZIP, PAK,
  8. ZOO, LZH, and ARC files providing that you have a copy of FV.COM
  9. and the necessary archive managers in your path.
  10.  
  11. FV.COM is Vernon Buerg's addon for LIST. It is available on most
  12. BBSs.
  13.  
  14. The syntax for grepfv is
  15. grepfv "regexp" filepattern[+] tempdir
  16. where
  17.  
  18. REGEXP is a pattern made up of ASCII characters plus the
  19. following special "wild cards". Enclose the pattern in quotes to
  20. avoid DOS misunderstanding the special characters. Searching for
  21. a backslash poses particular problems because DOS treats it as an
  22. escape character. To look for a backslash you actually have to
  23. specify "\\\\" as the pattern. DOS then translates this to "\\"
  24. which causes grepfv to look for a literal backslash.
  25.  
  26. All searches are case insensitive
  27.  
  28. REGULAR EXPRESSIONS:
  29. \            treat next char as literal
  30. .           match any single character
  31. *            match 0 or more characters
  32. &            preceeding expression AND following expression
  33. |            preceeding expression OR following expression
  34.  
  35. FILEPATTERN is a dos type file specification including wildcards.
  36. If you want to search all of the files in a directory then end
  37. the filepattern with a \. If you want to search all of the files
  38. in subdirectories too then add a + to the end of the filepattern.
  39. For example "\ns\" searches all files in the \ns directory,
  40. "\ns\nigel.*" searches all files in the \ns directory that are
  41. called nigel, "\ns\nigel.*+" searches all files called nigel in
  42. the \ns directory and all of its subdirectories.
  43.  
  44. TEMPDIR should preferably be a RAM disc. It is the location that
  45. grepfv will use to temporarily explode the files in the archives
  46. which it searches.
  47.  
  48. Examples
  49.  
  50. 1. grepfv "vga" tools.zip f:
  51. Searches all of the files in tools.zip for vga and uses drive f
  52. for temporary files
  53.  
  54. 2. grepfv "cga|vga" \tools\
  55. Searches all files in the directory \tools of the current drive
  56. for cga or vga using the current drive for temporary files
  57. because no alternative was specified. Note the trailing backslash
  58. on tools; without it grepfv would look for a file called tools in
  59. the root directory.
  60.  
  61. 3. grepfv "cga&vga" \tools\+
  62. Searches all of the files in tools and its subdirectories for
  63. line which contain both the word cga and vga.
  64.  
  65. Copyright
  66. ---------
  67. grepfv.zip may be distributed freely as long as this document
  68. is left unchanged.
  69.  
  70. If you keep it you should register it by sending a donation of
  71. not less than £10 to me. Please honour this arrangement I am in
  72. dire need of an upgrade for my development machine.
  73.  
  74. Corporate users can obtain a site license for £50
  75.  
  76. Overseas registration costs a minimum of £20 because my bank
  77. charges £10 to cash a foreign cheque.
  78.  
  79. Nigel Salt
  80. 25 Lower Station Rd
  81. Crayford
  82. Kent
  83. DA1 3PY
  84.  
  85. Phone 0322 553260
  86.  
  87. CIX ID nao@cix.complink.co.uk
  88. RAX Nigel Salt on node 2:440/52.49
  89.  
  90.